Quick Search

Description

Quick Search allows you to create a search inside of your grid. This feature is different from the Search part that you create on the Component Type page by clicking Grid contains a 'Search' part. Because the Quick Search is part of the grid, its properties are defined here as well. Selecting the Has Quick Search property adds a single search control to your grid part. If you want to add a control at the top of each field in your grid, check out the Query by Example properties. If you include a Search Part in addition to a Quick Search, then the Search Part will perform searches within the subset of records selected by the Quick Search.

Name
Description
Has Quick Search

Check the Has Quick Search property to enable the Quick Search feature in your grid.

Position

The Position property lets you specify where you want the Quick Search control to be placed. " In Grid " will display the Quick Search as part of the Grid part. " Above Grid " will display it as a separate control above the Grid.

Alignment

'Alignment' specifies if the Quick Search should be " Left ", " Center ", or " Right " aligned within the Grid. This property is available only applies if   Position  is set to " In Grid ".

Field(s) to search

As with the Detail or Search Part, the Quick Search needs to be told where to search for data. The Field(s) to search property is where you specify which fields in your grid you want the Quick Search to conduct a search. Clicking the button to the right of the Field(s) to search property will open the Select Field(s) to Search dialog. This dialog gives you the option of to Search a single field or to Search multiple fields .

Default Field to search

Specify the field in the Grid part to search if the Grid has not be sorted on a column.

Allow QBF style

Enables QBF style. QBF style causes the search argument "A,B,C" to search for A, B, or C. The search argument "A..C" searches for entries between A and C. The search argument "C.." searches for entries greater or equal to C. 'The search argument "..C" searches for entries less than or equal to C. 

Search style

Specifies how the data should be searched.

Control type

While most of the examples here have used a simple textbox for the Quick Search  feature, there exist other options. The Control type  property lets you quickly swap out the default ' Textbox ' Quick Search control for a ' Dropdownbox ', ' Radiobutton ', or ' Checkbox ' control and visa versa.

Choices

Specify the choices to show in the Quick Search.

Maximum number of choices

Specify the maximum number of choices to show. Set to 0 for no limit.

Has 'ShowAll' radio button

Specify if the radio buttons should include a button to show all records

'ShowAll' button label

Label for the 'ShowAll' radio button

Has 'Clear QuickSearch' button

Specify if the QuickSearch part should include a button to clear the QuickSearch.

'Clear QuickSearch' button label

Label for the 'Clear QuickSearch' button

Initial selection

Specifies the initial selection in the Quick Search. Leave this property blank if all records should be shown when the Grid is initially displayed. For example, say that your Quick Search does searches on a State field, and when the Grid is displayed initially, you want to show records for "MA".

Control inline style

Overrides the style for the Quick Search control. Click [...] to define the In-line style. Refer to the Style Editor for details.

Dropdownbox height

Specify the height of the dropdownbox. If the height is greater than 1, you can allow the user to select multiple entries.

Dropdownbox select style

Specify if the user can select multiple entries, or just a single entry.

Textbox size

Only applies if the Control type property is set to "TextBox". Sets the width of the textbox control.

Textbox maximum length

Only applies if the Control type property is set to "TextBox". Sets the maximum width of the text that can be entered into a textbox control. Set to -1 for no limit.

Orientation

Specify the orientation of the Quick Search control.

Search button label

Specifies the label for the Search button. Applies only if the Auto Submit property is set to False. This is the button that the user clicks to perform the Quick Search.

Auto submit

When the user makes a selection in the Quick Search, should the search be performed immediately, or should the search only be performed when the user clicks the 'Search' button?

Quick Search label

Specifies the label for the Search button. Applies only if the Auto Submit property is set to False. This is the button that the user clicks to perform the Quick Search.

Quick Search label style

Overrides the style for the Quick Search lable. Click [...] to define the In-line style. Refer to the Style Editor for details.

Has freeform layout

Specifies if the Quick Search has a freeform layout. This will allow you to specify any HTML for the text that surrounds the Quick Search.

Freeform layout

Specify the freeform layout for the Quick Search. You can specify any HTML for the text that surrounds the Quick Search.

Search rules

Specifies rules that should be applied when performing different types of searches.

Defining a Quick Search

The Quick Search feature allows you to make a search control part of a grid.

Filtering a Grid with Quick Search

Quick Searchis an option for a grid component that allows you to quickly filter and re-display its contents. To add Quick Search to a grid:

See Also